home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / moveit14.zip / MOVEIT.DOC < prev    next >
Text File  |  1991-08-29  |  11KB  |  233 lines
  1.                              MOVEIT!!! version 1.4 
  2.  
  3.                                 - Written by -
  4.                                 Garry W. Elmer
  5.                                     K-9 BBS
  6.                                FIDONET 1:320/105
  7.                                 1-203-536-1300
  8.                      
  9.                      Docs by Bill Winterholer, GEMSTONE BBS
  10.                Encouragement by David Hallford, CASA DE CRICKET BBS  
  11.  
  12.                       THIS IS NOT PUBLIC DOMAIN SOFTWARE!
  13.  
  14.            *******************  TO THE CURIOUS  ******************* 
  15.                                 August 27, 1991 
  16.          To the people that always wonder, "Who registers this stuff? 
  17.          Does anyone?" to date, the answer is NO.  This little program 
  18.          has been out and about for over a year now and NOBODY has ever 
  19.          registered it.  I don't even really know if anyone is using it.
  20.          This is not "sour grapes", but I've been asked by friends about
  21.          it, and have wondered myself before I wrote this program.  Now
  22.          I know. 
  23.            ******************************************************** 
  24.  
  25.  
  26.         Much time was spent in designing, charting and writing this program, 
  27. and hopefully it, and it's successors - if any - will be exactly what you 
  28. needed.  If you like it, and use it, and have $10 to spend, send it along to 
  29. help me know the effort wasn't fruitless.
  30.  
  31.                         Send a check or money order to:
  32.  
  33.                                   Garry Elmer        
  34.                                  63 Clift St.
  35.                               Mystic, Ct.   06355
  36.                     Suggestions and encouragement welcome!
  37.                                    
  38.  
  39.                                    WARRANTY
  40.  
  41.         Every effort was taken to ensure a quality program.  However, because 
  42. of the uncertainty of how it will be used, or on what equipment it may be 
  43. used, I make no guarantees or warranties of any kind, nor will I hold 
  44. responsibility for any type of damage caused by this program.  
  45.                               As always: BACK UP!
  46.  
  47.  
  48.                                    OVERVIEW
  49.  
  50.         MOVEIT!!! was written with the intent to make easier the movement of 
  51. files from different File libraries by Sysops using QUICKBBS.  However, it is 
  52. possible that it will work with any BBS that uses the file 'FILES.BBS' to list 
  53. available files in it's library.
  54.         MOVEIT!!! allows you to select a Source library and a Destination 
  55. directory, and then move selected files within the Source Directory to the 
  56. Destination directory.  It will add the new file to the Destination library's 
  57. FILES.BBS and delete it from the Source's, and also create a FILES.BAK.
  58.         MOVEIT!!! will support up to 200 directories at 500 files per 
  59. directory.  The program was written using ANSI control characters so the 
  60. program can be used as a door.  HOWEVER, this version does not redirect the 
  61. output to the modem, or check for a carrier. 
  62.         With MOVEIT!!!, File Library maintenance is now MUCH easier than using 
  63. the Quickbbs Move a file option. 
  64.  
  65.                                      SETUP
  66.  
  67. Setup:
  68.  
  69.         First, you will need to create a control file called ALLFILES.CTL or
  70. a similar BBS support file that follows the examples below.  This file should 
  71. contain the complete path to each file library and cannot include any spaces 
  72. before or in the path.  Comments may be added after the path, but must be 
  73. separated from the path by a space.  MOVEIT!!! will use the comments if 
  74. provided. 
  75.  
  76.         Examples:
  77.  
  78.         D:\BI\                   (Will display  "D:\BI")             
  79.         C:\QUICK\AREA1\          (Will display  "C:\QUICK\A") 
  80.         D:\BI\ 30 BIMODEM        (Will display  "BIMODEM")  
  81.         C:\QUICK\AREA1\ GAMES    (Will display  "GAMES")  
  82.  
  83.         Note that, in the first two examples, the paths stand alone, while in 
  84. the third and fourth examples, the paths are followed by comments.
  85.  
  86.         Next, make sure you have ANSI.SYS - or and equivalent - loaded, and 
  87. that COMMAND.COM is selected as the COMSPEC (this is usually done by DOS).  If 
  88. any of the drives, directories, or FILES.BBS cannot be located, the program 
  89. will exit with an error. 
  90.  
  91.                                RUNNING MOVEIT!!!
  92. Command Line Parameters:
  93.  
  94.         Moveit! may be called using one or all of three commandline 
  95. parameters:
  96.  
  97. -gc  
  98.    This enables the program to run in color graphics (default is Mono)
  99.  
  100. -m[drive]:\[path]\[filename]
  101.    This allows Moveit to use another file rather than ALLFILES.CTL
  102.    Example: Moveit -mC:\QUICKBBS\FLSEARCH.CTL
  103.  
  104. -rr
  105.    Will allow the program to accept numeric codes from the keypad (NUM LOCK
  106.    enabled!) for use remotely.  The program should work through a suitable 
  107.    door program.  In this version, however, the carrier is not monitored, nor
  108.    is the output redirected to the COM PORT.
  109.  
  110. Directories:
  111.  
  112.         When run, the program will produce two columns titled SOURCE (on the 
  113. left side of the screen) and DESTINATION (on the right side of the screen).  
  114. Under these will be the file library directories as listed in ALLFILES.CTL.  
  115. Initially, the cursor position will be in the Source column, with one of the 
  116. file library directories highlighted.  Movement with the up, down, pageup or 
  117. pagedown keys will move the highlight bar accordingly, allowing you to change 
  118. the source directory.  Moving with either the left or right cursor (arrow) 
  119. keys will bring you into the Files column and cause the FILES.BBS listing of 
  120. the highlighted directory to bed displayed in the center of the screen.  
  121. Again, use of the up, down, pageup, or pagedown keys will allow up and down 
  122. movement to select files.  Use the left cursor key to move into the 
  123. Destination column and - once again - use the up, down, pageup or pagedown 
  124. keys to select the destination directory. 
  125.         If a truncated (0 length) FILES.BBS is found, the program will not 
  126. allow you to select it as Source, but will allow it to be used as Destination.
  127.  
  128. Files:
  129.  
  130.          Moving back to the Files column: when the FILES.BBS of the source 
  131. directory is displayed, a FILES.MOV file is created.  To mark a file for 
  132. moving, place the -> cursor next to the file and press the space bar.  An 
  133. asterisk (*) will indicate the file is marked.  Pressing the space bar again 
  134. will unmark the selected file.  Depressing the "C" key will clear all the file 
  135. marks in the selected directory. 
  136.  
  137.         The "marked" file(s) will go to the destination directory that was 
  138. selected when the file was marked.  Changing destination directories will not 
  139. effect the destinations of previously marked files.  You can empty an entire 
  140. UPLOADS directory in one move operation.   
  141.  
  142.         If the file name is listed in FILES.BBS but is not found in the actual 
  143. library directory, a NOT FOUND will follow it.  These can be marked, and the 
  144. description line will be deleted from the FILE.BBS when the transfer is 
  145. initiated. 
  146.  
  147.  
  148. Deleting Files and Descriptions: 
  149.  
  150.         The "D" key will enable the DELETE function.  All files marked for 
  151. transfer will be deleted and their associated descriptions deleted when the 
  152. Carriage Return is depress.  Depressing the "D" key again will turn off the 
  153. DELETE function. 
  154.  
  155.         The "K" key will delete the actual selected files, leaving the 
  156. descriptions intact. 
  157.  
  158.         The "L" key will delete the descriptions of the selected files, but 
  159. leave the files in the source directory.  These files can be placed back on 
  160. the list with the "O"rphan function.
  161.  
  162. Moving Files:
  163.  
  164.         Moving a file is accomplished simply by hitting the Enter (Return) 
  165. key.  The files selected for moving in the Source directory, with it's 
  166. description in FILES.BBS, will be moved to the Destination directory and the 
  167. FILES.BBS there.  Then, the file and description will be deleted from the 
  168. source directory.  You cannot move a file if the Source and Destination 
  169. directories selected are the same, and the program will not allow you to move 
  170. files to a partition that is not large enough to hold the files you've marked.
  171.  
  172. The Display Line: 
  173.  
  174.         The display line at the bottom of the screen displays the highlighted 
  175. files size in Kbytes and the age of the file in months.  Also, the total size 
  176. of all the files marked to be moved is displayed in Kbytes, along with the 
  177. amount of Kbytes free in the selected Destination directory.  
  178.  
  179. When destinations are changed, the MARKED total will reflect the total "K" of 
  180. files marked for the destination PARTITION. 
  181.  
  182. The Message window at the end of the display line will give various messages 
  183. as the need arises.  Also, errors and illegal keys will also cause a beep. 
  184.  
  185. "Orphan" Files:
  186.  
  187.         "Orphan" files are the files in your file directory that, for one 
  188. reason or another, do not show in your FILES.BBS text files.  The "O" key will 
  189. select the ORPHAN files mode.  When first selected, a fairly long sort/search 
  190. routine is enabled.  Upon completion of this search and sort, a list of all 
  191. the files in the directory, that do not appear in the FILES.BBS text, will be 
  192. displayed.  The file titles may be included in the FILES.BBS text by marking 
  193. the desired files with the SPACE bar and depressing ENTER.  The DELETE mode 
  194. can also be enabled and the selected files will be deleted.  The FILES.ORF 
  195. file that appears in the list is a utility file that has already been 
  196. deleted.  To escape from the Orphan Files Mode, depress the "O" key again.
  197.  
  198.                         WARNING WARNING WARNING
  199.  
  200. Deleting the FILES.BBS, or FILES.BAK, could cause loss of the FILES.BBS text 
  201. file!!!!!  Do not delete these files!!!!!
  202.  
  203.                         WARNING WARNING WARNING
  204.  
  205. EDIT File Descriptions:
  206.  
  207.          The "EDIT" mode is entered by depressing the "E" key.  This will 
  208. enable you to scroll through the selected directory and change or delete the 
  209. description lines in the FILES.BBS text file.  Depressing the SPACE bar will 
  210. call the selected line to the bottom section of the screen.  A new description 
  211. may now be typed in if desired.  Depressing the ENTER key will end the edit 
  212. session and will allow you to save what you have typed, exit without changing 
  213. the line, or delete the entire description line from the FILES.BBS text file.  
  214. This DOES NOT delete the file from the directory, but "orphan's" the file.  To 
  215. exit the EDIT mode, depress the "E" key.
  216.  
  217. HELP:
  218.  
  219.         Help is available in the form of a menu that appears when the program 
  220. initially starts, or whenever the question mark (?) is pressed.
  221.  
  222. GETTING OUT OF MOVEIT!:
  223.  
  224.         The program can be terminated using the Tilde (~), or the ESC key.
  225.  
  226.  
  227.             MOVEIT!!! is FREQable from the following FIDONET BBS's:
  228.  
  229.               K-9 BBS         1-203-536-1300  FIDO 1:320/105 (CT)
  230.               Gemstone BBS    1-203-449-8747  FIDO 1:320/157 (CT)
  231.               Casa De Cricket 1-619-571-9971  FIDO 1:202/506 (CA)
  232.    
  233.